cliradio
========

A command-line internet radio player script designed to work with `mpg123` in Linux and Unix-like systems.

## Installation ##

`cliradio` depends on the `mpg123` utility to work. Install it, then download cliradio with the following command:

    wget -o cliradio https://notabug.org/kzimmermann/cliradio/raw/master/cliradio

And run:
    
    ./cliradio

Or, alternatively, copy it to somewhere in your executable path:

    sudo cp cliradio /usr/local/bin

And run it from any directory:

    cliradio

## Usage ##

The script looks for a `.radiolist` file located in the user's home directory. If you do not have one, a sample one will be created one based on the example file included in this repository. Add your own radios to the list by using the following syntax is:

    # You can comment like this.
    name>Description or name of the Radio
    url>http://urlofradiostation.com/playlist.pls

Do notice that you must link directly to the `.pls` file.

The script is interactive, and will build a list of radio stations available for you to tune in. To stop streaming a radio, press Ctrl+C.

## Radio stations ##

Pretty much any Radio Station streaming in mp3 will work, although I haven't tried a lot of them. I do know that [Shoutcast](http://www.shoutcast.com) and [SomaFM](http://somafm.org) stations work, though. 

If you listen to other independent radio stations, please test `cliradio` with them and let me know! I would like to support them as much as I can!

## Bugs, suggestions, and the like ##

Get in touch with me! I'd love to see this script ported to other shells and languages!
